home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir34 / dos999.zip / 1106.TXT < prev    next >
Text File  |  1993-05-11  |  8KB  |  177 lines
  1. _____________________________________________________________________
  2.  
  3. Stacker Note                                     Stacker Note                     
  4.                      
  5. STAC FAX Index #1106                 
  6.                      
  7.                      
  8.                           Stacker API v. 2.0
  9. _____________________________________________________________________
  10.  
  11. What can the Stacker API do for you?
  12.  
  13. 1.  Make your programs more compatible with Stacker.
  14.  
  15.          Using the API you can now determine if Stacker is
  16.          installed on a system, what version of Stacker is
  17.          running, and which drives in the system are Stacker
  18.          drives.  If the Stacker drives have been swapped, you
  19.          can find out what drives they have been swapped with.
  20.          You can determine if a Stacker coprocessor is installed,
  21.          which coprocessor it is, and the hardware address where
  22.          it is installed.  If a Stacker drive replaces its host
  23.          drive your software can now have direct access to the
  24.          underlying host drive if it needs it.  This and much
  25.          more has been provided to help you enhance your
  26.          product's compatibility.  We think the most common use
  27.          of these features will be in installation programs
  28.          which want to detect Stacker andoptimally configure
  29.          the software that they are installing for a Stacker
  30.          based system.  You'll probably think of lots of other
  31.          things to do with all this information.
  32.  
  33. 2.  Give you direct access to Stacker's compression and
  34.     decompression engines.
  35.  
  36.          If Stacker software is installed on a PC you can now
  37.          use its high performance compression and decompression
  38.          to improve the performance of your product.  You can
  39.          transmit data in half the time, and store it in half
  40.          the space.  You can reduce memory usage by keeping
  41.          infrequently used data structures in compressed form
  42.          and decompress them when needed.  Speed up your
  43.          software by keeping overlays compressed in EMS or XMS
  44.          and then decompressing them when needed instead paying
  45.          the seek time it costs to read them from disk.  If a
  46.          Stacker coprocessor is installed you'll get even faster
  47.          performance and tighter compression.
  48.  
  49.          If you are already using one of Stac's LZS221 or DCS221
  50.          compression libraries, you will want to investigate
  51.          using the Stacker API to detect if Stacker is present
  52.          in a system.  If it is, you may want to use the API to
  53.          access Stacker's compression engine which, although
  54.          less general in its interface, provides over fifty
  55.          percent better speed performance over DCS221 or LZS221.
  56.  
  57. 3.  Give you the ability to read compressed data directly
  58.     from a Stacker drive.
  59.  
  60.          Now you can transfer compressed data directly from a
  61.          Stacker drive, to tape, to backup floppies, across a
  62.          modem, or over a network without having to pay the
  63.          performance penalty of having Stacker first decompress
  64.          the data.  The data format is the same LZS compressed
  65.          data format that is supported by all of our compression
  66.          products.  This means that when you need access to the
  67.          compressed data you can decompress it using our 9703,
  68.          9704, or 9705 compression chips, our LZS221 compression
  69.          libraries (available in 8088, 80386, and 68000 assembly
  70.          as well as C), or the Stacker API.  This is also the
  71.          same compressed data format as the QIC-122 data
  72.          compression standard which is used in quarter inch tape
  73.          drives.
  74.  
  75.     The version 2.0 Stacker API includes the following:
  76.  
  77.         - A 78 page manual with examples for each function,
  78.           a section on testing considerations for your
  79.           programs and a section on developing Stacker aware
  80.           installation programs.
  81.  
  82.         - A C library for all memory models of Borland C
  83.           and Microsoft C.
  84.  
  85.         - An include file for Assembly language programs.
  86.  
  87.         - An OBJ file and Pascal unit for Turbo Pascal
  88.           programs.
  89.  
  90.         - Six Ready to compile and run programs in C plus
  91.           one in Assembly.  These programs include a sample
  92.           Stacker aware installation program, a sample program
  93.           to read files from a Stacker drive in compressed
  94.           form, a sample program that simulates sending a file
  95.           across a modem with and without compression, plus
  96.           several more.  In addition to the source code for
  97.           these programs there are example programs for each
  98.           function in the API.
  99.  
  100.         - Developer assistance on CompuServe.
  101.  
  102. Here's what the Stacker API can provide to make your programs
  103. Faster, Smaller and More Compatible with Stacker:
  104.  
  105. Informational items:
  106.  
  107.         - Is Stacker installed?
  108.         - Is Stacker hardware or Stacker software being used?
  109.         - The major and minor versions of the Stacker device
  110.           driver.
  111.         - The hardware address of the Stacker coprocessor.
  112.         - The hardware type of the Stacker coprocessor (XT/8,
  113.           AT/16 or MC/16).
  114.         - Is Stacker using EMS for its cache?
  115.         - Is the Stacker driver loaded high (above 640k)?
  116.         - The number of available replaceable Stacker drives.
  117.         - Which drives are which after swapping.
  118.         - Is a drive is Stacked?
  119.         - Is a Stacker drive mounted?
  120.         - Is a Stacker drive an auto-mounting drive or not?
  121.         - Is a Stacked drive write protected?
  122.         - Is a Stacked drive replaced with the host drive?
  123.         - Was a Stacked drive mounted damaged?
  124.         - The number of erased sectors and the number of free
  125.           sectors for a given Stacker drive.  These two figures
  126.           can be used to determine the minimum (physical) space
  127.           available for a Stacker drive.
  128.         - The BPB of a Stacked drive (without having to go to
  129.           disk).
  130.         - The BPB of the host drive of a Stacked drive (without
  131.           having to go to disk).
  132.         - The drive unit number for a Stacked drive.
  133.         - The drive unit number for the host drive of a Stacker
  134.           drive.
  135.         - The stacvol file name for a Stacker drive.
  136.         - The major and minor versions of Stacker that was used
  137.           to create a given Stacker drive.
  138.         - Pointers to the interrupt and strategy routines for
  139.           the host drive of a Stacker drive.  This can allow you
  140.           to access the host drive of a replaced Stacker drive.
  141.         - The number of bits per FAT entry for a Stacker drive.
  142.  
  143. Compression items:
  144.  
  145.         - Compress data using the Stacker device driver.
  146.         - Uncompress data using the Stacker device driver.
  147.  
  148. Drive state manipulation items:
  149.  
  150.         - Flush the Stacker device driver for all Stacker drives.
  151.         - Unmount Stacker drives.
  152.         - Put a Stacker drive in "host drive mode".  This allows
  153.           you to access the host drive of a Stacker drive
  154.           (including swapped and replaced drives) through a
  155.           drive letter.
  156.         - Take a Stacker drive out of "host drive mode".
  157.         - Set the write-protect status on a Stacker drive in the
  158.           Stacker device driver.
  159.         - Remove the write-protect status on a Stacker drive in
  160.           the Stacker device driver.
  161.  
  162. Read compressed data items:
  163.  
  164.         - Read clusters directly from a Stacker drive in
  165.           compressed form.
  166.         - Retrieve the FAT entry for a given cluster on a
  167.           Stacker drive.
  168.  
  169. For information on how you can purchase the Stacker API, call
  170. Stac Electronics at 619-431-7474, extension 2910,For pricing.
  171. Existing Stac OEM customers who have purchased our 
  172. compression/decompression libraries or chips are entitled to 
  173. the Stacker API free of charge.
  174.  
  175. _______________________________________________________________
  176. Copyright 1992, Stac Electronics
  177.